3.2 Kurzanleitung

Folgende Arbeitsschritte sind in der typischen Umgebung (IVS läuft unter Informix / Postgres) notwendig:

1. 1. Zunächst entpacken Sie das Archiv ivs<<Versionsnr>>_superx_<<Encodierung>>_<<Datenbanksystem>>.tar.gz als User superx (nicht als root) an der Stelle $SUPERX_DIR. Die Variable <<Encodierung>> kann "iso" oder "utf8" sein. Die Locale beim Entpacken (Variable LANG) sollte dieser Encodierung entsprechen.  

2. 2. Einrichtung der IVS-bezogenen Umgebungsvariablen - Prüfen Sie ob in Ihrer $SUPERX_DIR/db/bin/SQL_ENV alle Einträge aus SQL_ENV.IVS.sam vorhanden sind, ggfs. rüberkopieren ). Aktivieren Sie die Umgebung mit
   . $SUPERX_DIR/db/bin/SQL_ENV  

3. 3. Benennen Sie die Datei $SUPERX_DIR/db/module/ivs/rohdaten/IVS_ENV.sam nach IVS_ENV um und passen Sie die Umgebungsvariablen für den FSV-Datenbankrechner an.  

4. 4. Entscheiden Sie sich zunächst für ein "Push"- oder "Pull"-Verfahrne beim Entladen. Die häufigsten Modi sind erfahrungsgemäß: "Push" bei IVS unter Informix (Unix), "Pull" bei allen andere Systemen.
   Beim Entladen aus IVS unter Informix im "Push"-Modus: Kopieren sie den Verzeichnisinhalt unter $SUPERX_DIR/db/module/ivs/rohdaten zum IVS-Rechner, bzw. mounten Sie das Verzeichnis auf dem SuperX-Rechner 2 . Laden und testen Sie dann die Umgebung in IVS_ENV.
   Beim Entladen aus IVS unter Postgres im "Pull"-Modus: Laden Sie die Umgebung in IVS_ENV und richten Sie mit dem propadmin.x die Datenbankverbindung zum IVS-Rechner ein. Achten Sie bei Postgres darauf, dass bei FSV ab Version 12 die Variable
   JDBC_PARAM="set search_path to mbs;"
   gestetzt sein muss (siehe Musterdatei IVS_ENV.sam ). 

5. 5. Ausführen des Entladescripts $SUPERX_DIR/db/module/IVS/rohdaten/ivs_unload.x für die Basisdaten. Ggf. Kopieren des Rohdaten-Verzeichnis der entladenen IVS-Daten nach $SUPERX_DIR/db/module/ivs/rohdaten
   Ein Scripte dafür heißt ivs_copy.x  

6. 6. Laden Sie für die folgenden Schritte die Umgebung für SuperX
   . $SUPERX_DIR/db/bin/SQL_ENV
   Erzeugen des IVS-Moduls in der SuperX-Datenbank:
   $SUPERX_DIR/db/module/ivs/ivs_modul_erzeugen.x
   Falls ein Fehler auftritt, versuchen Sie die Ursache zu beheben, starten Sie dann
   $SUPERX_DIR/db/module/ivs/ivs_modul_entfernen.x
   (etwaige Fehler können normalerweise ignoriert werden)
   und anschließend erneut
   $SUPERX_DIR/db/module/ivs/ivs_modul_erzeugen.x
    

7. 7. Nur wenn Sie Tomcat auf einem separaten Rechner betreiben: Fügen Sie den Inhalt der Datei
   $SUPERX_DIR/webserver/tomcat/webapps/superx/WEB-INF/ivs_dbforms_config_<<pg für Postgres oder ids für Informix)>>.xml vom Kommentar "<!--Hier beginnt Moduldefinition-->" bis zum Kommentar "<!--Hier endet Moduldefinition-->" in Ihre dbforms-config.xml ein.
   Danach starten Sie Tomcat neu. 

8. 8. Übernahme der entladenen IVS-Daten nach SuperX:
   $SUPERX_DIR/db/module/ivs/ivs_update.x
    

9. 9. Prüfen des Update, Testen der Abfragen 

10. 10. Schritt 10 kann jede Nacht wiederholt werden. Dazu muss der Entladerhythmus geplant werden, und die Cronjobs werden eingerichtet.